home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / prom202b.zip / INSTALL.EXE / PONYTRAN.DOC < prev    next >
Text File  |  1992-05-30  |  5KB  |  140 lines
  1.  
  2.  
  3.                  PONYTRAN File Transfer Program
  4.              Copyright (c) 1992 Sun Country Software
  5.                            Version  1.02
  6.  
  7.  
  8.  
  9.  
  10. Whats New - 05-23-92 
  11. -----------------------------------------------------------------------
  12. + Added DSZ compatible log file.  We do not provide as much information
  13.   as DSZ does but enough to get File size Baud Rate CPS and Filename.
  14.  
  15. Whats New - 04-09-92 
  16. -----------------------------------------------------------------------
  17.   Corrected bug that wouldn't recognize a dropped carrier during 
  18.   transfers.
  19.  
  20. Whats New - 02-28-92 
  21. -----------------------------------------------------------------------
  22. + Passing baud rate does not hang up now.  Passing Baud Rate will now
  23.   allow for accurate time estimates, CPS and Efficeincy calculations.
  24.  
  25. Whats New - 02-23-92 
  26. -----------------------------------------------------------------------
  27. + Cleaned up display on Times to remove extra digit.
  28.  
  29.  
  30. Whats New - 02-20-92 
  31. -----------------------------------------------------------------------
  32. + Cleaned up some of the Log entries for Activity logs.
  33. + Cleaned up some code that caused Ymodem/Ymodemg to not complete file
  34.   transfers correctly.  It should work fine now.  
  35.  
  36.  
  37.  
  38. ------- Overview ------------------------------------------------------
  39.  
  40.  
  41. PonyTran is a command line program that provides one transmit or one 
  42. receive protocol session. To start a Zmodem protocol transmit of all 
  43. the PAS files in your directory you would type the following:
  44.  
  45.  PonyTran /c 2 /b 9600 /z /t *.pas
  46.  
  47. PonyTran will open Com2 at 9600 baud and transmit all PAS files using 
  48. the Zmodem protocol. After all the PAS files have been transmitted 
  49. PonyTran will report the ending AsyncStatus value. 
  50.  
  51. To send a list of files you would use @FileList
  52.  
  53. If you wish to  transmit additional files then you would rerun PonyTran
  54. with appropriate parameters.
  55.  
  56. Let's take a look at all of the PonyTran parameters and discuss them in
  57. turn:
  58.  
  59.     Usage: PonyTran [options] SrcFilename
  60.  
  61.       /B BaudRate  Baudrate 
  62.       /C #         Comport name   [default = 1]
  63.       /T           Transmit mode  [default]
  64.       /R           Receive mode
  65.       /S           ASCII transfer
  66.       /X           Xmodem/XmodemCRC [default]
  67.       /K           Xmodem1K
  68.       /L           Xmodem1KG
  69.       /Y           Ymodem
  70.       /G           YmodemG
  71.       /Z           Zmodem
  72.       /F           Kermit
  73.       /A           Zmodem option - resume interrupted transfer
  74.       /O           Zmodem option - always overwrite files
  75.       /N           Zmodem option - only overwrite if newer
  76.  
  77. /B BaudRate - If you do not specify a baud rate PonyTran will open 
  78. the specified port without disturbing its existing parameters. 
  79. You would typically omit the baud rate whenever you are running 
  80. PonyTran as a DOS EXEC or Shell from some other communications program 
  81. (so that PonyTran would use the line parameters left by the parent 
  82. program).
  83.  
  84. /C # - This is the Com port number you wish to use. If you omit this
  85. parameter Com1 will be used. PonyTran supports Com1-Com4 on PCs and ATs,
  86. Com1-Com8 on PS/2s.
  87.  
  88. /T - Specifies that you wish to transmit files. This is the default.
  89. Whenever you are transmitting files you must supply a file mask (or
  90. file name) as the last parameter on the command line.
  91.  
  92. /R - Specifies that you wish to receive fies. If the protocol you've
  93. selected doesn't support file names (Xmodem and Ascii) then you must
  94. supply a receive file name as the parameter on the command line. If
  95. the selected protocol does support file names then any name you
  96. specify on the command line will be ignored.
  97.  
  98. /S .. /F - Specifies the protocol you wish to use. PonyTran supports all
  99. standard protocols.
  100.  
  101. /A .. /N - Specifies a few Zmodem options that you might want to
  102. experiment with. /A resumes interrupted file transfers. It can be
  103. specified by either the transmitter or receiver. /O tells Zmodem to
  104. always overwrite existing files (the default is to skip existing
  105. files). /N tells Zmodem to overwrite existing files only if the
  106. incoming file has a later time stamp.
  107.  
  108. PonyTran will use hardware flow control,PonyTran will never use software 
  109. flow control.
  110.  
  111. PonyTran will display the progress of the protocol transfer.
  112.  
  113.  
  114.  
  115. PonyTran will read the Environment variable PTLOG if it is set and 
  116. will create a log of all transmitted and received files. It will append 
  117. to the this file if it already exists. The log entry consists of the 
  118. protocol type, file name, whether it was transmitted or received and 
  119. whether the transfer was successful or not. PonyTran's logging routine 
  120. will also delete partially received files unless the protocol in use was 
  121. Zmodem (since Zmodem could resume the transfer from the point of 
  122. interruption).
  123.  
  124. PonyTran also reads Environment variable PTBBS if it is set and 
  125. will write Wildcat Activity log format if it is set to WILDCAT.
  126. will write pcboard Activity log format if it is set to PCBOARD.
  127.  
  128.  
  129. If the Environment variable PTLOG is not set then the log file will 
  130. not be created.
  131.  
  132.  
  133. Zmodem uses its own file management rules. PonyTran uses the default of
  134. WriteProtect which means it will skip files that already exist at the
  135. destination. You can modify this with the /O and /N command line
  136. parameters. Note that Zmodem doesn't have a rename option.
  137.  
  138.  
  139.  
  140.